





Oh Sier: 





The 64 Column Operating System 


For the Timex/Sinclair 20b& 
Personal Color Computer 


ZEBRA SYSTEMS INC. &| BIBLIOTECA SAGITTARII 


August le. 2013 
Electronic Version by: Alfstangard 


Publication Credits 


Original manual by 


ZEBRA SYSTEMS, INC. 

74-Ob Jamaica Avenue 
Woodhaven, NY Li4el 

716-296-2345 

©1945 


Electronic Version: 


Alfstangard Alfstangardsonu ©2013 


QA ?6-9-S65Z4e2 15985 


Contents 
Publication Credits --.-eeeeeeeeee 


OVERVICW wee e eee e nent ewe e neces 
Limitations Of The 64 Column Mode 
Using The Cartridge ........+..0.. 
Centronics Printer Support -....... 
OVERVICW ee eee cece eee cece ee tec nne 
Selecting An Interface.-.....--. 
Sending Control Codes & Graphics 
Printer Output Width...--.....-. 
Changing Printer Width........-. 


ID hte tees: ehca sid se asc foc<es ice ra a> ice rie ses tei caraas sas voice: tecses wicetuat as wider erte 


Suppressing System Linefeed/Carriage Return... - eee eee eee eee ee eee eee eens 


Centering COPY Output-.....22eee 
Important Printer Notes.-.--.------ 
OS-bY Variances cece ccnncncaencae 
GPEPNICS «vaiwestesn iueeee rece ees 
Screen Saving eee cece eee ceneaecee 
Using OS-b4 with ZEBRA Disk Drives 
Extended System Variables .-...-..- 
OS-b4 Memory Map «see eee ee eee eeees 


OS-b4Y 


The b4 Column Operating System Cartridge 


Overview 


The OS-b4 cartridge is a normal Timex/Sinclair 20b& operating system 
modified to provide a complete b4 column environment- OS-b4 provides the 
following. 


1) b4 columns on screenai this includes... 
a) LISTings 
b) PRINTing 


c) Editing 


2) b4 columns to your Centronics printer, this includes... 
a) LPRINT 
b) LLIST 
c) COPY - Epson compatible only) 


Complete Centronics printer support is built in and it is virtually user 
transparent. With OS-b4 what you see on the screen (in b4 columns) is what 
you get on your Centronics printer. 


OS-b4 generates b4Y characters per line on screen by using the T/S 20b8's 
special b4 column video mode. 


Limitations Of The b4 Column Mode 


The b4Y column video mode is a powerful hardware option because it doubles 
the amount of textual information that you can display on your screen; 
enabling you to program more professional applications- As is usual with 
small computers, advanced features require trade-offs with other features. 
This is very true with the TS20b&'s advanced video modes- Below I will 
discuss the limitations of the TS20b&'s 64 column mode. 


The b4Y column mode requires the user the use of a monochrome or RGB 
monitor. The visual quality of text on Color TVs or color monitors will 
probably be unacceptable. 


The b4 column video mode does not provide FLASH- As a result the BASIC 
keyword FLASH will not do anything- Also. the editing line cursor will not 
FLASH. 


There is no separately selectable BORDER color’ the BORDER is 
automatically set to the current PAPER color. 


There is no local (temporary) PAPER or INK- In 0S-64, all PAPER and INK 
commands have global effect.i that is. they change the entire screen- When you 
set PAPER. the INK automatically gets set to a complimentary color and vice 
versa. 


Using The Cartridge 


There's not much to it- Just turn the power to your computer off.i plug the 
OS-b4 cartridge ini and power up the computer- Voila! A b4 column enhanced 
operating system is at your fingertips- Just about everything works the same 
as the normal system, except you have the 64 column format- 


One of the things you will have to learn about is the built-in Centronics 
printer support. 


Centronics Printer Support 


Overview 


OS-b4 does not support the Timex/Sinclair 2040 printer- LPRINT/LLIST/COPY 
output goes to your Centronics printer if you have a Centronics interface 
attached to your computer- Built in to the system is code to support the 
following Centronics interfaces... 


1) Aerco 

2) Tasman-B 
3) Tasman-C 
4) A& Jd 

5) Oliger 


A single POK will select your interface- If you desire. you can provide 
your own interface driver in RAM and select it for system use- This allows 
you to drive devices with any protocol (This includes RS232., as well as 
Centronics). 


Selecting An Interface 


To select one of the five interfaces listed above. POKE address 65523 with 
the following values: 


1) Aerco 1b? 
2) Tasman-B 135 
3) Tasman-C lee 
WY) A& J 145 


5) Oliger 1b? 


To select your own interface driver positiona at address 'N!’ in RAM you 
have to alter the new system variable IFDR_addr to point to your routine- Use 
the following commands to do this... 


< POKE 65523, N - INT (N/25b) > 
< POKE 65524, INT (N/25b) > 


If after selecting your own interface drive you want to reselect a system 
driver use the appropriate POKE from the descriptions plus the following... 


< POKE 65524, 63 > 


Sending Control Codes & Graphics Data 


There are two types of data that can be sent to your Centronics printers 
Character or Control codes- Each is handled differently within the system. If 
you want to send control codes or graphics date to your printer you must 
first signal the system by altering the new system variable PRDAT_typ 
(printer data type). 


To select control code output... 
< POKE 65514,1 > 

To re-select character output... 
< POKE 65514,0 > 


In practice you should only select control code output for the brief 
period necessary to actually pass the control codes and then immediately re- 
select character output- Below is an example of this method- In this example 
we are sending the control codes for Emphasized Print mode to a Star Micronic 
SG10 


Example 


10 POKE 65518,1 = REM PRDAT_typ=cntrl code 
CO LPRINT CHR&S 275 CHRS £95 = REM cntrl codes out 
30 POKE 65518,0 = REM PRDAT_typ=character 


Printer Output Width 


Output width to your Centronics printer defaults to b4 columns to 
logically match the screen; what you see on the screen is exactly what you 
get on your printer- This b4 column output is not centered on the paper; but 
most printers have control codes to set the left margin- Below is an example 
of how you would center the LLIST/LPRINT output for a Star Micronics SG1O0- 


Example: 
10 POKE 65518,1 = REM PRDAT_typ=cntrl1 code 


CO LPRINT CHRS 275"M"™5CHRS 4&5 = REM cntrl codes out 
30 POKE 65518,0 = REM PRDAT_typ=character 


Changing Printer Width 


To change printer output width. do the following... 
< POKE b5525.,width : RANDOMIZE USR 15be23 > 
Note: Maximum width is 255 characters. 


Suppressing System Linefeed/Carriage Return 


The system normally generates a Carriage return and a Linefeed code after 
each 'width’ no# of characters. but we can suppress this by doing the 
following... 


< POKE 65510,0 : REM suppress linefeed> 
< POKE 65511,0 : REM suppress carriage return > 


If you suppress carriage returns. you will become responsible for deciding 
when you want a carriage return- You will have to explicitly send this code 
when necessary: You could use the following routine to do this... 


10 POKE 65518,1 
CO LPRINT CHR# 134 
30 POKE 655186;,0 


Suppressing the system CR/LF will effect LLIST so you will have to be 
careful to consider this during program development. 


To restore normal CR/LF operation, POKE 65510,13 & POKE 65511;510- 


Centering COPY Output 


COPY output is normally aligned with the left-hand side of the printer 
paper. OS-b4 has a built-in facility to allow COPY centering if you should 
desire it- Eight bytes in the extended system variables area are reserved as 
a COPY centering control code table- The control codes necessary to set the 
left-hand margin for printing are different from printer to printer- If you 
can determine the control code sequence for your printer, you can POKE them 
into the table 1 thereby centering all the subsequent COPY output. Below is 
an example for the Star Micronics SG10 printer. 


10 POKE 65528,3: REM length of the subsequent cntrl code sequence 
70 POKE 65529,27: REM ESCAPE code 

30 POKE 65530,77: REM set left margin code 

4O POKE 65531,19: REM left margin at column 14 


Please note that memory address 65528 holds the length of the subsequent 
control code sequence- It is very important to have this correct. 


Important Printer Notes 


e Embedded print commas cause a linefeed.- 


e COPY routines reset all printer modes to power up defaults. 


e At the end of LPRINT/LLIST output to your Centronics printer the 
printer's buffer may still have the last bit of LPRINT/LLIST data 
stored but unprinted. Executing < LPRINT > will force the remaining 
buffer to be printed. 


e If you are outputting to your Centronics printer and it does goes 
offline (error, paper-out. power-off). oppressing BREAK will not 
immediately return you to BASIC- This is because. at BREAK time. the 
print-out routine does special output to clear the printer, and if 
the printer is offline it will wait until you service the printer 
and bring it back online. before terminating. 


OS-b4 Variances 


The OS-b4 in most respects is a fully functional equivalent to your normal 
system- The few areas where the OS-b4 varies from your normal system will be 
discussed in the following sections. 


Graphics 


Under the OS-b4 your screen display is actually 512 pixels wide but you 
cannot access this double horizontal from BASIC- The following graphics 
commands: PLOT. DRAW. CIRCLE. work exactly as they do in the normal system. 
You specify (X,iY) coordinates where X has the range of 0-255 and Y has a 
range of 0-175. The graphics will be drawn exactly as you would expect. 


The graphics command POINT works a bit differently in OS-b4 than with your 
normal system- Normally POINT tests the single screen pixel specified and 
returns the value zero if that pixel is off or the value one if that pixel is 
on- With the OS-b4 you use the specification coordinates with the same range 
(X = 0-255) but two pixels are tested at once and the actual pixels tested 
(in the Sle wide screen) are ((X*2),Y) and (((X*2)+1)5Y)- The following 
values are returned by the POINT command and reflect the status of the two 
pixels tested... 


0 = Both pixels off > OO 
1 = Right pixel on > O1 
2c = Left pixel on > 10 
3 = Both pixels on > Li 


Screen Saving 


The normal method of SAVEing screens will not work for b4 column screens, 
To SAVE a 64 column screen you must SAVE two separate code blocks back-to- 
back as follows... 


< SAVE "name™ CODE 163864,6144: SAVE "name™ CODE 2457bsb144 > 
To LOAD your saved screens back into memory. do the execute commands... 


< LOAD "name™ CODE 16384: LOAD "name" CODE 2457b > 


Using OS-b4 with ZEBRA Disk Drives 


OS-b4 is compatible with the ZEBRA disk drive with the following 
exceptions. 


1- When you press the reset button on the disk drive interface module, 
the 0S-b4 will not boot up properly unless you ensure that there is 


a- No disk in drive 'A', or 


b- You have a 'START' program on the disk in drive 'A'’ with the 
following as its first line: < OUT 244,53: RANDOMIZE USR 
3379 >. or 


c- For the OS-b4 boot and auto-CAT on reset: < OUT 244,43: 
RANDOMZE USR 3379: CAT * >. or 


d- For the 0S-b4 to boot and auto-start a program on reset: < OUT 
C4453: RANDOMIZE USR 3379: LOAD x*"™name™ >. 


2C- Due to a lack of foresight on the TOS programmers’ part. the Disk 
MERGE command will not work with OS-b4 without special POKES 
directly preceding MERGE commands- The following technique should 
allow you to MERGE from disk: < POKE 26064,195: POKE 2bOb5,144: POKE 
260661253: MERGE *x"™name™ >. 


Extended System Variables 






























































Number Address Name Contents 

Of Bytes 

2 b550Lb > Unused locations. 

2 65508 Xpos Used by COPY routine. 

1 65510 CR Code here is sent out by LPRINT and LLIST 
as carriage return. 

1 65511 LF Same as above but for linefeed. 

2 65512 COPY_addr Address of the Centronics COPY routine. 
Normally points to ROM; but. you can alter 
it to point to your own routine. 

1 65514 - Unused location. 

1 65515 Hpos Used by COPY routine. 

1 bS5Lb COLM Used by COPY routine. 

1 65517 MAXcl Highest column in printer buffer with 
character in it- 

1 65518 PRDAT_typ Printer data type: O = character; 1 = 
control codes or graphic data- 

1 655149 LINE Used by COPY routine. 

1 65520 Ypos Used by COPY routine. 

2 65521 = Unused locations. 

e 65523 IFDR_addr Interface driver routine address- Normally 
points to ROM, but. you can alter it to 
point to your own routine. 

1 65525 WDTH Printer output width. 

1 b55eb = Unused location. 

1 65527 FLAGSnew Various control flags. 

4 65528 COPYtab Table of control codes for COPY centering 
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